Skip to content

(feat): windows how-to#82

Merged
levilentz merged 4 commits intoscaleapi:mainfrom
levilentz:feature/windows
Feb 26, 2026
Merged

(feat): windows how-to#82
levilentz merged 4 commits intoscaleapi:mainfrom
levilentz:feature/windows

Conversation

@levilentz
Copy link
Contributor

@levilentz levilentz commented Nov 25, 2025

Generated code creating windows build.ps1 files as well as updated README's for windows users. I have tested the build.ps1 in both agentex and agentex-ui.

Greptile Summary

This PR adds comprehensive Windows support for the Agentex development workflow by introducing PowerShell build.ps1 scripts that mirror the existing Makefiles, a dedicated WINDOWS.md guide, and platform-specific sections across all READMEs.

  • Three new build.ps1 scripts (root, agentex/, agentex-ui/) faithfully replicate all Makefile targets with proper error handling and parameterization
  • New WINDOWS.md provides a complete end-to-end Windows guide covering prerequisites, setup, command reference, troubleshooting, and IDE configuration
  • Existing READMEs updated with macOS/Linux vs Windows (PowerShell) section headers and equivalent PowerShell commands
  • WINDOWS.md has broken relative links in the Additional Resources section (../README.md should be README.md since the file is at the repo root)

Confidence Score: 4/5

  • This PR is safe to merge — it only adds documentation and PowerShell scripts without modifying any application code.
  • The PR is purely additive (docs + scripts), PowerShell scripts faithfully mirror the Makefiles, and the author has tested both build.ps1 scripts. One minor bug: broken relative links in WINDOWS.md.
  • WINDOWS.md has broken relative links in the Additional Resources section that should be fixed before merge.

Important Files Changed

Filename Overview
README.md Adds Windows callout, platform-specific section headers (macOS/Linux vs Windows), and PowerShell equivalents for prerequisite installation and setup commands. No issues found.
WINDOWS.md New comprehensive Windows development guide. Contains broken relative links in the Additional Resources section (uses ../ prefix when the file is at repo root).
build.ps1 Root-level PowerShell script mirroring the root Makefile with repo-setup and help commands. Clean implementation with proper error handling.
agentex/build.ps1 Backend PowerShell build script faithfully mirrors the agentex Makefile. Covers install, dev, test, migration, docs, and Docker commands with proper error handling and parameter support.
agentex-ui/build.ps1 Frontend PowerShell build script faithfully mirrors the agentex-ui Makefile. Covers Docker build/run/push, development, linting, and typecheck commands.
agentex/README.md Adds Windows support section with quick start PowerShell commands and a Makefile-to-PowerShell command reference table. No issues found.
agentex-ui/README.md Adds Windows callout, platform-specific sections for backend startup and dev server, and PowerShell script command reference. No issues found.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["Developer on Windows"] --> B{"Which tool?"}
    B -->|"Root repo"| C["./build.ps1"]
    B -->|"Backend"| D["agentex/build.ps1"]
    B -->|"Frontend"| E["agentex-ui/build.ps1"]

    C --> C1["repo-setup"]

    D --> D1["install / install-dev"]
    D --> D2["dev / dev-stop / dev-wipe"]
    D --> D3["test / test-unit / test-integration"]
    D --> D4["migration / apply-migrations"]
    D --> D5["docker-build / serve-docs"]

    E --> E1["install / dev"]
    E --> E2["build / build-and-load"]
    E --> E3["run / run-detached / stop"]
    E --> E4["typecheck / lint"]
    E --> E5["push / build-and-push"]
Loading

Last reviewed commit: 9a524fa

(5/5) You can turn off certain types of comments like style here!

@levilentz levilentz requested a review from a team as a code owner November 25, 2025 06:54
@levilentz levilentz enabled auto-merge (squash) February 26, 2026 19:33
@levilentz levilentz merged commit d83ff4c into scaleapi:main Feb 26, 2026
10 of 11 checks passed
Copy link

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

7 files reviewed, 1 comment

Edit Code Review Agent Settings | Greptile

Comment on lines +333 to +336
- [Main README](../README.md) - General getting started guide
- [Agentex Backend README](../agentex/README.md) - Backend-specific details
- [Agentex UI README](../agentex-ui/README.md) - Frontend-specific details
- [Python SDK](https://github.com/scaleapi/scale-agentex-python) - Agent development examples
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Broken relative links in Additional Resources

Since WINDOWS.md is at the repository root, these ../ prefixed paths resolve to the parent of the repo root, making all four links broken. They should use relative paths without the ../ prefix.

Suggested change
- [Main README](../README.md) - General getting started guide
- [Agentex Backend README](../agentex/README.md) - Backend-specific details
- [Agentex UI README](../agentex-ui/README.md) - Frontend-specific details
- [Python SDK](https://github.com/scaleapi/scale-agentex-python) - Agent development examples
- [Main README](README.md) - General getting started guide
- [Agentex Backend README](agentex/README.md) - Backend-specific details
- [Agentex UI README](agentex-ui/README.md) - Frontend-specific details
- [Python SDK](https://github.com/scaleapi/scale-agentex-python) - Agent development examples
Prompt To Fix With AI
This is a comment left during a code review.
Path: WINDOWS.md
Line: 333-336

Comment:
**Broken relative links in Additional Resources**

Since `WINDOWS.md` is at the repository root, these `../` prefixed paths resolve to the *parent* of the repo root, making all four links broken. They should use relative paths without the `../` prefix.

```suggestion
- [Main README](README.md) - General getting started guide
- [Agentex Backend README](agentex/README.md) - Backend-specific details
- [Agentex UI README](agentex-ui/README.md) - Frontend-specific details
- [Python SDK](https://github.com/scaleapi/scale-agentex-python) - Agent development examples
```

How can I resolve this? If you propose a fix, please make it concise.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants